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How to Install Franklin Editor 

1 . Create a franklin directory in a location of your choice on your hard drive. These instruction assume 
you create C:\franklin\ 

2. Download the self-extracting FranklinEditor from 

httDj^nolith,adtech.inte^^ Wf> ^ ^ filp m n 

temporary directory on you hard drive. 

3. Double-click on FrunklinEdhor.exe in the temp directory on you hard drive. This will start the 
WinZip Self-Extractor. Under "Unzip to folder" enter C:\franklin\ or the path to the franklin directory 
you created m Step 1. Click on "Unzip". y 

4 Go to C:\frankIin\FranklinEditor on your hard drive. Open frankliu. properties file in NotePad If 
the location of your browser is different from the one listed, remove the # in front of browserPath and 
change me value to the appropriate path on your machine. Save and close the file. 

5. Double-click on C:\fi^Idm\FnuiklinEditor\FranklmEditor.bat file. The login screen will popup 
and prompt for your username and password which the Franklin team has provided to you. 

How to Delete Franklin Editor 

1 . Simply delete the franklin directory you created on your hard drive. 
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How to Get Started with Franklin Editor 

After installing the Editor by following the How To Inst all instructions and logging in you can take the 
actions listed below. When Franklin runs integrated with the Kitty Hawk workfl^eng^e uS^cL 
work in one of two modes: superuser or regHiacmer. a user can 



Note: 

All icons in the Editor UI display a tooltip if you mouse over the icon. 
Useful error messages appear in the status bar at the bottom of the Editor UI. 

ACTIONS FOR SUPERUSER 
ISJsearch 

Click on the "Search" icon above the Active List. This brings up the Search UI. Select attributes and 
Hint: A search that will always bring back results is "Page Type is Fragment" 

Once search results are displayed in the table, you can select one or more of them and merge them into 
the Active List in the Editor UI by clicking on the "Merge with Active List" icon llll 

SScheck Out for Edit 

Select an item in the Active List and click on the "Checkout selected document" icon If the document is 
no locked by another user, it will appear in the right-hand pane in editable widgeS You^ mo^anv 
fields and resubmit into Franklin server. See "Check in" moony any 

ISlcheck Out for View 

Select ap item in the Active List and click on the "View selected document in read only mode" icon It 
wi 1 be displayed in the right-hand page in editable widgets. However, yo* ^t be Xfo cSn in 
with any changes. You can click on the "Check out" icon above the right-hand pane to fheU it oS for 

(-^Create New Fragment 

Click on the "Create new document" icon. This brings up the list of fragments and pages vou are 
altowed to create. Select a fragment, click on "Create". The Editor UI rSev^he SSXdTD 

Siri TZgTV**" ^ With ^ neldTThigmigrted 

in yellow, and must be filled m before you are allowed to check in the document. 

Create a New Page 

Create a page the same way you create a fragment. However, note that a page has additional fields that 
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enable it to be turned into a final HTML page and previewed: 



A page includes one or more subfragmcnts. To include a subfragment into a page under construction^ 
do the following: ^ 

• Search for all subfragments of the appropriate document type (see Search), and merge them into your 
Active List J 

• Select the subfragment you wish to include from the Active List 

• Click on the "Copy" icon above the Active List M 

• Click on the subfragment field in the page under construction 



• Click on the "Paste" icon above the right hand pane. ISl This will write the fragment ID of the pasted 
fragment into the field, 

A page requires "Publishlnfo" to be filled in. You must select a publish directory on the server This 
is Where the final page will be saved. You must also enter the final HTML file name for the published 
page. You must also select a style sheet to render the page in HTML. 

See "Preview" to view the final HTML page. 
Check in 

Once you have created a new document or modified an existing one, click on the "Check in document" 
above the right-hand pane. The document will be validated against the DTD and sent to the Franklin 
server. You can now search for it to check it out again for modifications. 

Preview a Page 

Before checking in a page, you can preview it by clicking on the "Preview page" icon above the right- 
hand pane It will launch the browser you specified in ihefranklin.properties file during installation. The 
browser will display the output HTML generated using the style sheet listed in the first PUBLISHINFO 
of the page. To see all output pages, you need to check : in the page and then click on the "Approve" 
icon. 



Note that you can make further changes to the page and preview it again before checking it into the 
server. You can also preview any page (but not a fragment), by selecting it from the Active List and 
clicking on the " Preview page" button above the Active List 

Irt 



Approve document 



To approve the publishing of a fragment or a servable, select it in the Active List and click on the 
Approve final pages for selected document" icon. This will launch a browser and display a list of all 
resulting HTML pages. For a fragment, the list consists of all final HTML pages of all the servables that 
include the fragment as a subfragment For a servable, the list consists of all final HTML pages of that 
servable. 



Create problem report 



If you find a problem with a final page, create the appropriate problem report by clicking on the "Create 
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problem report' 1 icon. 

document 

If you find no problems with any of the final pages you are approving, click on the "Publish document" 
icon above the Active List. The selected document will be published to the server. 

©move current document 

While editing a document in the right-hand pane, you can click on the "Remove current document" icon 
This will unlock the document on the server and discard the document being edited from the Editor UI. ' 

ACTIONS FOR REGULAR USER 

Get Task List 

Select "Tasks -> Show Task Interface" from the menu bar to retrieve current tasks assigned to you in the 
workflow engine. 3 

l&llJpdate Task List 

To refresh title entries in the Task Dialogue, click on the "Update task list" icon. Note that after you first 
launch i the Task Dialogue the tasks do not get automatically updated. You have to explicitly ask for the 
list to be updated. r j ^ 

^Initiate Task 

To begin working on an assigned task, select the task and click on the "Initiate selected task" icon A 
Create task will open a new document template to fill in, an Edit task will check out an existing 
document, and a Publish task will launch a browser to approve pages to be published. Once you check- 
in or publish the document mitiated by a task, the task will disappear from the task dialogue. 

t^lview task info 

To view task associated with a document in the Active List or in the right hand panel, click on the "View 
tesk associated with selected document" icon. It will bring up the Task Dialogue with the appropriate 
task selected. Note that this icon is only enabled for documents that are associated with a task. 

The other actions you will be able to take in the Franklin Editor UI as a regular editor are described 
above m the guperuser section . Allowed actions will be identified by the icons being highlighted. 
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